home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 1 / PC World Interactive 1 - Nisan 1997.iso / nostalji / bbs / music / sbbook.arj / SBBOOK / DMP / DMPC.DOC < prev    next >
Encoding:
Text File  |  1993-10-09  |  9.0 KB  |  210 lines
  1.  
  2.                      Dual Module Player Companion
  3.                              Version 1.72
  4.                       (C) 1993 Psychic Psoftware
  5.  
  6.  
  7. This program is CARDWARE/SMILEWARE, that is, you may distribute it freely as
  8. long as you don't charge any fee for it and if you want to continue using it,
  9. please send me a postcard of your hometown (or a letter with a picture of your
  10. hometown included).  If you have any comments (gripes?) about this product,
  11. email me at cslm@alpha.ru.ac.za (I may even fix some things!).
  12.  
  13.  
  14. DMPC was written as a front end for the Dual Module Player ((C) 1992, 1993 Otto
  15. Chrons).  DMPC was originally coded just before I had to write an examination,
  16. so don't expect miracles (not big ones anyway).  It was designed to be small and
  17. fast rather than big and flashy, and with with the logo & swapper it's now
  18. small, fast and flashy!  Hopefully this will make using the command-line driven
  19. DMP (An excellent product!) easier to use.
  20.  
  21.  
  22. Legal stuff: If this program does anything that is antisocial to your computer,
  23.              hey, shit happens.... and I'm not responsible.
  24.  
  25.  
  26. Features: - Supports: MOD, STM, AMF, S3M, 669, NST, VOC, WAV and SND.
  27.           - Reads the directory much faster than ModPlay v2.19b ((C) Mark Cox).
  28.           - Reads up to 1000 music files in any directory.
  29.           - Reads/plays music files from inside ARJ, LHA/LZH and ZIP archives.
  30.           - Mouse support.
  31.           - Play a list of files sequentially or in random order.
  32.           - You can use DMP or PMP (and almost any other player... but who would
  33.             want to use anything but the best?)
  34.           - Selection window accomodates 43/50 line mode.
  35.           - Switch between 25 and 43/50 line modes.
  36.           - Load/Save tagged selection.
  37.           - Change drive/directory.
  38.           - Fast file find with partial matching.
  39.           - Help page.
  40.           - Extract to temp directory.
  41.           - Recognises Amiga style MOD.NAME format.
  42.           - Delete files.
  43.           - Multiple config definitions.
  44.           - Shell to DOS.
  45.           - Format inclusion masking.
  46.  
  47.  
  48. Keys: Up and down scroll through the list of music files.
  49.       ENTER will play the file you are currently on OR changes the directory
  50.             if you selected a directory.
  51.       SPACE will tag/untag a file.
  52.           T tags all.
  53.           U untags all.
  54.           D delete current file.
  55.           P plays all tagged files in order or if there are no tagged files, it
  56.             will act like ENTER.
  57.           R does the same as P except that it specifies random selection.
  58.           S Save current tagged selection to file.
  59.           L Load a tag selection from file (clears previous tagged selection).
  60.           . Re-read current directory.
  61.           V Switch line mode (if possible).
  62.           C Change drive.
  63.           F Find a music file by name.
  64.           H Display help page.
  65.        1..0 Select config 1-10
  66.         F10 Shell to DOS
  67.  
  68.       To move faster up and down the list you can use PG UP/PG DN or HOME/END.
  69.       P and R specify -l so that the mods don't loop.  When your tagged
  70.       selection includes archived files, DMPC will de-archive and play them
  71.       one at a time (for disk space reasons) randomly or sequentially.  If DMPC
  72.       is controlling the selection play then pressing N in DMP will not take
  73.       you to the next file in the selection (for obvious reasons) but if you
  74.       press ESC it will play the next file.  Press ESC twice in fast succession
  75.       if you want to quit a DMPC controlled selection (and I mean fast!).
  76.  
  77.       Pressing V will try to switch your screen from 25 to 43/50 line mode (if
  78.       you are in 25 line mode) or from 43/50 to 25 line mode (if you are in
  79.       43/50 line mode).
  80.  
  81.       If you have a mouse, moving the mouse up and down will do the same as the
  82.       up and down arrow keys.  The left button emulates P and the right button
  83.       emulates SPACE.
  84.  
  85.  
  86. DMPC has a config file (DMPC.CFG) for the command-line switches that you would
  87. use when loading DMP.  The format of the config has changed (for the better)
  88. from that of the previous versions of DMPC.  It now can have multiple devices
  89. and players.  All blank lines & lines beginning with a ; will be ignored (if you
  90. put a . on the options line, it will leave the options blank).  The first line
  91. is for defining your TEMP directory.  After that the config follows a simple
  92. format, DEVICE NAME, COMMAND-LINE OPTIONS, FILE INCLUSION MASK and PLAYER.
  93. Device name can be up to 30 characters long, options and player definitions can
  94. be up to 40 characters long.  The file inclusion mask is a list of characters
  95. that represent the different formats that a player can play.
  96.           M = MOD    S = STM    N = NST    6 = 669    V = VOC
  97.           W = WAV    3 = S3M    D = SND    F = AMF
  98.  
  99. Example config file (between the <--- ---> lines):
  100.  
  101. <--- BEGINNING OF CONFIG FILE --->
  102. ;TEMP directory
  103. C:\TEMP
  104.  
  105. ;SoundBlaster configuration
  106. SoundBlaster
  107. -p220 -i5 -d1 -q -8 -l -c1
  108. ;MOD, STM, NST, 669, S3M, AMF
  109. MSN63F
  110. DMP.EXE
  111.  
  112. ;Setup for a MONO DAC on port 3BC
  113. Mono DAC
  114. -p3BC -c6 -q -8 -l
  115. MSN63F
  116. DMP.EXE
  117.  
  118. ;Modplay setup
  119. Modplay 2.19b
  120. .
  121. ;MOD only
  122. M
  123. MP.COM
  124. <--- END OF CONFIG FILE --->
  125.  
  126. DMPC will search the path for ARJ.EXE, LHA.EXE, PKUNZIP.EXE (or UNZIP.EXE),
  127. DMP.EXE and DMPC.CFG, if it can't find DMPC.CFG in the path, current directory
  128. or the directory where DMPC.EXE was executed from it will take -p42 -c6
  129. (PC SPEAKER!! <--- Yech!) and DMP as default.  If ARJ.EXE cannot be found (using
  130. the same search technique as for DMPC.CFG), DMPC will not search ARJ files for
  131. music files (similarly for LHA and ZIP).  When a file occurs decompressed and in
  132. archives, only the decompressed file is shown in the list of available music.
  133.  
  134.  
  135. Limitations: If you don't have EMS or XMS (preferably EMS) on your machine
  136.              (something I would find hard to believe on a 386!), DMPC will crawl
  137.              when you try to play anything 'cause it will be swapping to disk.
  138.              DMPC will not work on Hercules displays.
  139.  
  140.        Now stop reading this dumb DOC and go and play some music! *8)
  141.  
  142.  
  143. Revision history:
  144.  
  145.     1.72 : File inclusion mask for different players 'cause some players can't
  146.            play S3M etc.  Added WAV/SND/VOC support (no validation is done on
  147.            the files though).
  148.  
  149.     1.71 : Made DEVICE NAME longer.  Fixed two non-critical bugs with config.
  150.  
  151.     1.70 : NST supported (finally).  Full path searching.  Extracts to temp
  152.            directory.  Fixed change drive & screen clearing bugs.  Archive
  153.            searching speeded up (again!).  Amiga type mod name MOD.NAME format
  154.            recognised.  Improved find to do partial matching inside names if no
  155.            partial match was found on start of name.  Can now delete files from
  156.            inside archives.  Read 1000 files in any directory.  Multiple config
  157.            definitions.  F10 to swap to DOS.
  158.  
  159.     1.60 : Added ZIP support.  DMPC logo by Sand.  Optimized archive searching
  160.            routines.  Re-read current directory.  Switch to/from 43/50 line
  161.            mode.  Change drive.  Fast find routine.  Help page.
  162.  
  163.     1.51 : Fixed a nasty bug that deleted non-archived files once played.
  164.  
  165.     1.50 : ARJ/LHA support added.  EMS/XMS/Disk swapper added.  Directory
  166.            changing (for all the people who love their subdirectories) has been
  167.            added.  STM files are now read in (but I only was able to test it on
  168.            converted MOD files).  Use DMP or PMP according to your needs.
  169.            43/50 line mode is used when detected.  Load/Save tag selections.
  170.            Fixed some small bugs (some of which were bigger once I opened the
  171.            hood to have a look at what was causing the problem).
  172.  
  173.     1.40 : Mouse support!
  174.  
  175.     1.30 : Support for 669, AMF and S3M added, sequential tagging, delete
  176.            function.
  177.  
  178.     1.20 : Fixed a few bugs in previous releases.
  179.  
  180.     1.10 : Added HOME/END, PAGE UP/DOWN, elementary tagging, multiple play with
  181.            or without random selection.
  182.  
  183.     1.00 : Original release.
  184.  
  185.  
  186. Thanks to:
  187.  
  188.    Otto Chrons for writing DMP/PMP (ask him about DSMI).
  189.    Robert Jung for the tech info about ARJ files in UNARJ230.EXE
  190.    Thomas Wagner for his PD swapout routine.
  191.    Thayne Breetzke for his advice and positive criticism.
  192.    Bryan Kilian for helping me get DMPC from just an idea into such a popular
  193.     program.
  194.    Rory Freeman for various helpful routines.
  195.    Sand (K. Sunley) for designing a really cool ANSI screen for DMPC.
  196.    Mark Adler (found it again!) for sending me the ZIP header format.
  197.    Toni Nikkanen for becoming a registered DMPC user... *8)
  198.    All the people who have responded so positively (and negatively?) to DMPC!
  199.  
  200.  
  201. Todo:
  202.  
  203.    Sample preview functions?
  204.    ZOO/SQZ/WAU support? (Email me if you would like these supported)
  205.    Make this DOC more readable. (Anyone going to volunteer?)
  206.  
  207.  
  208.    If you can think of anything else you want to see in future releases, just
  209.    pop me some email at the address mentioned above.
  210.